---
title: Authentication
subtitle: Troubleshooting authentication issues
image: "https://og.composio.dev/api/og?title=Authentication%20Troubleshooting"
keywords: 'authentication, oauth, connections, scopes, troubleshooting'
hide-nav-links: true
---

## Using Composio's default OAuth app

When using our default OAuth configuration:

- **Don't add additional scopes** - They may not be approved in our OAuth app
- Use only the pre-configured scopes provided

## Using custom OAuth apps

Ensure your OAuth app is configured correctly:

- **Redirect URL**: Must match exactly what's configured in your OAuth provider
- **Scopes**: Auth config scopes must match your OAuth app configuration
- **Credentials**: Verify client ID and secret are correct

For setup guides by toolkit: [OAuth Configuration Guides](https://composio.dev/oauth)

## Common authentication issues

- **Invalid redirect URI**: Check the callback URL matches exactly
- **Scope mismatch**: Ensure requested scopes are configured in both auth config and OAuth app
- **Expired tokens**: Try refreshing the connection
- **Rate limits**: Some providers limit authentication attempts

## Reporting authentication issues

When reporting to support, provide:

- **Error message**: Complete error details and screenshots
- **Auth config ID**: The `authConfigId` being used
- **Connected account ID**: If a connection was already created
- **OAuth provider**: Which service you're trying to connect

## Getting help

- **Email**: support@composio.dev
- **Discord**: [#support-form](https://discord.com/channels/1170785031560646836/1268871288156323901)